Inside Macintosh: QuickTime Components /

Chapter 5 - Sequence Grabber Components / Sequence Grabber Components Reference

Sequence Grabber Component Functions / Controlling Sequence Grabber Components

SGStartRecord

The SGStartRecord function instructs the sequence grabber component to begin collecting data from its channels.

pascal ComponentResult SGStartRecord (SeqGrabComponent s);

s

Specifies the component instance that identifies your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenDefaultComponent or OpenComponent function.

DESCRIPTION

The sequence grabber stores the collected data according to the recording parameters you specify with the SGSetDataOutput function, which is described on page 5-24. Before calling this function, you must correctly configure the sequence grabber's channels--see "Working With Channel Characteristics" beginning on page 5-55 for information about configuring sequence grabber channels.

RESULT CODES

cantDoThatInCurrentMode	-9402	Request invalid in current mode
notEnoughMemoryToGrab	-9403	Insufficient memory for record operation
notEnoughDiskSpaceToGrab	-9404	Insufficient disk space for record operation
deviceCantMeetRequest	-9408	Device cannot support grabber

File Manager errors
Memory Manager errors

SEE ALSO

You can switch from previewing to recording by calling this function during a preview operation--you need not stop the preview operation first. You stop the recording process by calling the SGStop function, which is described on page 5-38.

You can cause the sequence grabber to display the data it obtains from its channels without storing any of the data by calling the SGStartPreview function, which is described in the previous section.

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help